Version 3.0 User's Guide
Editing Counters, Groups, and Global Variables	Previous | Next Contents

Editing Counters

Counters are automatically created as they are used in your HTML pages, but NetCloak also provides a way to create counters manually and to adjust their values. You can also remove counters that are no longer used, which is recommended to maximize the efficiency of the counter database. In addition, you can configure counters to automatically reset periodically.

To edit counters using the NetCloak CGI, choose the "Variables..." command from the "Configuration" menu. This will display the NetCloak Lists window, and the first tab is used to edit counters.

Figure 12: The Counters tab of the NetCloak Lists window.

To add a new counter, type its name into the "Name" field, enter a starting value into the "Value" field, and click the "Save Changes" button. To remove a counter, select it in the Counter List and click the "Remove Counter" button.

Clicking on a counter name in the counter list will cause the "Name" and "Value" fields to be filled in with that counter's name and current value. To change the value of a counter, click on the counter in the counter list, change the value in the "Value" field, and click the "Save Changes" button.

When using the plug-in version of NetCloak, you can use the NetCloak CGI to edit counters, as described above, but using the Web admin interface is preferred. To ensure that your updates take effect, quit your Web server while you are editing the counters with the CGI. After your edits are complete, quit the NetCloak CGI and re-launch the server.

To edit counters using the NetCloak Web admin interface, go to the admin URL in your Web browser, then click the "Counters" link. This will display the "Counters" admin page, containing a table of all the currently-defined counters.

Figure 13: The Counters page of the NetCloak Web admin interface.

To add a new counter, click the "New..." button at the bottom of the page. To edit the name, value, or auto-reset options of an existing counter, click the radio button next to the counter in the table, then click the "Edit..." button at the bottom of the page. In either case, you are then presented with the "Edit Counter" Web admin page.

Figure 14: The Edit Counter page of the NetCloak Web admin interface.

To change the name or value of the counter, change the name or value in the text fields, and click the "Save Changes" button.

For information on using counters within your HTML pages, see the "Commands: Counters" section in this Guide.

Resetting Counters Automatically

Each counter you create will, by default, start with the value you assign it, and increment by one each time an INSERT_COUNT command is processed, forever. However, you can create counters that reset to a value you specify on an hourly, daily, weekly, or monthly basis.

To make a counter reset automatically, check the "Automatically Reset Counter" checkbox.

In the CGI, this will enable the "Set To:" and "Every:" fields below. After setting automatic reset options, be sure to click the "Save Changes" button to save the changes to the counter.

Set To: Enter the value that the resetting counter will reset to at the specified interval.

Every: Click the up and down arrows to specify whether the counter will reset on an hourly, daily, weekly, or monthly basis.

At: If the counter resets on a daily, weekly, or monthly basis, this field becomes enabled. Click the up and down arrows to specify the time of day the counter will reset.

On: If the counter resets on a weekly or monthly basis, this field becomes enabled. Click the up and down arrows to specify what day of the week (for weekly resets) or day of the month (for monthly resets) the counter should reset on.

In the Web admin interface, click the radio button next to the desired reset interval (every hour, every day, every week, or every month), then select the reset date/time from the popup menus underneath that radio button. Click "Save Changes" for the changes to take effect.

Because the values of counters are important to the Webmaster, NetCloak creates a file called "NetCloak Counter Resets" within the "NetCloak Files" folder where it logs the date, the time, the counter name, the current value, and the reset value every time a counter is automatically reset.

Copyright © 1996-1999 Maxum Development Corporation http://www.maxum.com/	Previous | Next Contents